Skip to content

Audit Agent Experience Skill#79

Open
jay-sahnan wants to merge 6 commits intomainfrom
audit-agent-experience
Open

Audit Agent Experience Skill#79
jay-sahnan wants to merge 6 commits intomainfrom
audit-agent-experience

Conversation

@jay-sahnan
Copy link
Copy Markdown
Contributor

@jay-sahnan jay-sahnan commented Apr 25, 2026

Spawns parallel Claude subagents against a target docs/SDK/SKILL.md from a one-sentence prompt, captures structured traces, and renders a graded HTML report scoring Setup Friction, Speed, Efficiency, Error Recovery, and Doc Quality. Includes narrative cross-agent review to surface convergent hallucinations and silent workarounds the JSON self-report misses.


Note

Low Risk
Primarily adds new skill documentation/templates and a static prospecting profile, with no executable code changes beyond what future skill runners may follow.

Overview
Introduces a new audit-agent-experience skill, including a detailed SKILL.md playbook for running parallel subagent onboarding audits (config prompts, credential-handling guidance, trace parsing, scoring rubric, and report generation flow).

Adds supporting assets for the skill: an HTML report template (assets/report-template.html) plus reference docs (references/*) defining prompt variants, subagent trace schema/brief, and scoring rules, and includes a new MIT LICENSE.txt. Also adds a Browserbase prospecting profile JSON under skills/event-prospecting/profiles/.

Reviewed by Cursor Bugbot for commit 8f64258. Bugbot is set up for automated code reviews on this repo. Configure here.

jay-sahnan and others added 2 commits April 25, 2026 09:07
Spawns parallel Claude subagents against a target docs/SDK/SKILL.md from a
one-sentence prompt, captures structured traces, and renders a graded HTML
report scoring Setup Friction, Speed, Efficiency, Error Recovery, and Doc
Quality. Includes narrative cross-agent review to surface convergent
hallucinations and silent workarounds the JSON self-report misses.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Comment thread skills/audit-agent-experience/assets/report-template.html
Comment thread skills/audit-agent-experience/references/prompt-variants.md
Comment thread skills/audit-agent-experience/SKILL.md Outdated
Comment thread skills/audit-agent-experience/SKILL.md Outdated
Comment thread skills/audit-agent-experience/SKILL.md Outdated
Comment thread skills/audit-agent-experience/assets/report-template.html
Comment thread skills/audit-agent-experience/assets/report-template.html
Comment thread skills/audit-agent-experience/assets/report-template.html Outdated
Comment thread skills/audit-agent-experience/references/prompt-variants.md Outdated
Comment thread skills/audit-agent-experience/SKILL.md Outdated
@shrey150 shrey150 self-requested a review May 5, 2026 16:18
@jay-sahnan
Copy link
Copy Markdown
Contributor Author

@cursor review

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 3 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 8f64258. Configure here.

"Vertical automation — fintech, insurance, healthcare, legal, supply chain, GTM"
],
"researched_at": "2026-04-23"
}
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated file committed in wrong PR

Medium Severity

skills/event-prospecting/profiles/browserbase.json is unrelated to the Audit Agent Experience skill being added in this PR. It belongs to a separate event-prospecting skill (which has no SKILL.md or other files). It contains Browserbase-specific competitive intelligence (competitors, customers, use cases) that doesn't belong in this changeset. This is especially notable given the SKILL.md explicitly instructs "Never pre-fill a product, URL, or company" and "Ignore environment signals."

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 8f64258. Configure here.

.dimension-bar-fill.grade-c { background: var(--grade-c); }
.dimension-bar-fill.grade-d { background: var(--grade-d); }
.dimension-bar-fill.grade-f { background: var(--grade-f); }
.dimension-rationale { font-size: 0.875rem; color: var(--muted); }
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dead CSS for explicitly-disabled dimension breakdown section

Low Severity

Thirteen CSS rules for .dimension, .dimension-head, .dimension-bar-fill, etc. are defined in the template but are unused dead code. The SKILL.md explicitly states "do not render a per-dimension breakdown section" and no corresponding HTML elements or placeholders exist in the template body. This adds unnecessary weight to every generated report.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 8f64258. Configure here.

Comment thread skills/audit-agent-experience/SKILL.md Outdated
Classification heuristic:
1. If the same trace earlier contained a successful `llms.txt` WebFetch whose output mentioned this URL → `FROM LLMS.TXT`
2. Else if the same trace earlier contained any WebFetch/Bash output that mentioned this exact URL → `FROM PREV PAGE`
3. Else if the subsequent tool_result has `err: true` with 404 content → `GUESS · 404`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Field name mismatch in URL provenance classification

Medium Severity

The URL provenance classification heuristic in SKILL.md checks for err: true on tool_result events, but the trace schema defined in subagent-brief.md instructs subagents to use error: true. This field name mismatch means the orchestrator would fail to detect 404'd URLs, misclassifying GUESS · 404 results as TRAINING PRIOR — undermining the most valuable doc-discoverability signal in the report.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 8f64258. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant